home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,401 to 4,500 / aol-file-protocol-4400-4401-to-4500.zip / AOLDLs / PDA-Newton Development / Newt 3.4 (develop apps,pkgs).sit / newt-devenv-34.sit / regisnwt / ReadMe Register next >
Text File  |  1996-11-23  |  8KB  |  196 lines
  1.  
  2. About Newton Register
  3.  
  4. Newton Register lets you pay for a shareware program with a credit card via
  5. electronic mail.  Your payment will be sent to the Kagi Shareware clearing
  6. house (or another, if you prefer) and forwarded, minus a percentage, to the
  7. author.  If you have PocketMoney (or any Newton application which supports
  8. the Financial Package Posting Standard), the transaction may be
  9. automatically entered into your records.
  10.  
  11. Requirements
  12.  
  13. Register supports but does not require the ScrollingDoPopup extension; if
  14. you have the extension installed, you may try to register any program
  15. installed on your Newton, not merely those programs pre-configured in
  16. Register's menu.  If you choose a program from beneath the "In Your Extras"
  17. line, see the caveat below.
  18.  
  19. The program you are registering gets a chance to react to your registration;
  20. for example, if the program has expired, it might extend the expiration
  21. date.
  22.  
  23. Paying for a Program
  24.  
  25. To pay for a program, select it from the "Program" pop-up menu, select the
  26. price,* and enter your credit card information.  Then select "Mail"  from
  27. the envelope button; Register will look up your name and address and
  28. generate the proper form.  Double-check the form, then press the "Mail"
  29. button.
  30.  
  31. *If you're unsure of the price, enter "<" followed by the most you're
  32. willing to pay.  A clearing house which supports this feature (none, as yet)
  33. will look up the proper amount and bill it if it's less than or equal to the
  34. figure you specified.
  35.  
  36. Security
  37.  
  38. Note that Register merely sets up a mail message; the responsibility for
  39. actually executing it is yours.  In particular, you may not want to risk
  40. sending your credit card number via email.  If demand warrants, in the
  41. future Kagi Shareware may accept PGP encrypted credit card numbers.  The
  42. "normal" encoding method should discourage casual sniffers, but is not as
  43. secure as PGP.  Other methods should be used only for registration companies
  44. other than Kagi.
  45.  
  46. Credit Card Numbers
  47.  
  48. For security reasons, I don't let you store your credit card number.  Sorry.
  49.  But if you've stored the number somewhere else, you can enter the entire
  50. number (or NetCash certificate) into the first field.
  51.  
  52.  
  53. Caveat
  54.  
  55. If you try to register one of the programs beneath the "In Your Extras"
  56. line, if the author has not given Kagi Shareware permission to collect
  57. payments, Kagi will try to email you notification that your registration did
  58. not succeed.
  59.  
  60. Authors interested in receiving checks from Kagi Shareware should send their
  61. mailing address and developer signature to shareware@kagi.com.  For use of
  62. this program with shareware clearing houses other than Kagi Shareware, see
  63. below, under "For Programmers."
  64.  
  65. Cash and Checks
  66.  
  67. Kagi Shareware can accept checks in US dollars, or cash in many major
  68. currencies.  But please don't send cash or checks until you have received a
  69. registration number which must accompany your payment.  To do this, select
  70. the program you wish to pay for, and send an email message with the payment
  71. method set to "Query".  You will receive an email reply with further
  72. instructions.
  73.  
  74. For Programmers
  75.  
  76. ProtoMoneyButton
  77.  
  78. If you want to add a registration button to your package, I provide sample
  79. code to make this almost trivial, available on my home page.  In the
  80. simplest case, just make sure that the constants  kAppSymbol and
  81. kSharewareFee are defined, add the file MoneyButtonProto to your project,
  82. and drag out an instance of a ProtoMoneyButton.  This will put a "$" button
  83. on your package's status bar.  When the user presses the button, Register
  84. will be opened with your package and shareware fee selected.
  85.  
  86. SharewareFee slot
  87.  
  88. I  suggest that programmers who don't want to use a protoMoneyButton at
  89. least put a slot at the top level of their packages named SharewareFee,
  90. preferably containing an integer number of US dollars.
  91.  
  92. Register will also report the value of a top level slot named Version or VersionString. 
  93.  
  94.  
  95.  
  96. The :IPaid() Method
  97.  
  98. After the user has successfully entered his credit card number and selected
  99. your package, Register will try to call your top-level method entitled
  100. ":IPaid(frame)", if it exists.  See the sample code for details; one
  101. possible use is, if you have a nag dialog for unregistered users, to disable
  102. it for a week or two, presumably until you've been notified of the user's
  103. registration.
  104.  
  105. An Open Standard
  106.  
  107. The sample code shows how to do a great deal more customization.  In
  108. particular, you don't have to have your shareware payments sent to Kagi; you
  109. can even use my sample code to call another registration package.  The
  110. sample code and the :ExternalRegister(RegFrame) protocol are free to be
  111. modified and used for any reasonable purpose, specifically including use
  112. with competing registration programs and shareware clearing houses.  I
  113. intend this to be a fully open standard.
  114.  
  115. Other Clearing Houses
  116.  
  117. A competing shareware clearing house can even supply its own encoding method
  118. by using the EncodingType and EncodingFunction slots in the registration
  119. frame.  The "normal" encoding scheme is proprietary to Kagi; I will supply
  120. the decoding algorithm for the "minimal" encoding scheme to any clearing
  121. house of whose good faith I am convinced.  Note that the supplemental
  122. encoding function in the sample code is for illustrative purposes only and
  123. may not deter a skilled cryptanalyst.
  124.  
  125. Shareware Fee
  126.  
  127. Register itself is freely distributable but not free; it's shareware, but
  128. with an unusual fee structure.  If your users use it to register your
  129. software with Kagi, you don't have to worry about the fee; my 1% royalty
  130. will be collected by Kagi.  For use with other shareware clearing houses (or
  131. if you have the payment sent to you directly), the shareware fee for using
  132. Register (not the sample code) is still 1%, payable by the recipient of the
  133. payment.
  134.  
  135.  
  136.  
  137.  
  138. Where to get╔
  139.  
  140. ScrollingDoPopup
  141.  
  142. Hardy Macia's ScrollingDoPopup extension should be available on CompuServe,
  143. America OnLine, and on my home page at <URL:
  144. ftp://ftp.rahul.net/pub/flasheridn/
  145. hardymacia/ScrollingDoPopup.sit.hqx>
  146.  
  147. Financial Package Posting Standard
  148.  
  149. The specifications for the Financial Package Posting Standard should be in the above places or 
  150. <URL:ftp://ftp.rahul.net/pub/
  151. flasheridn/hardymacia/
  152. FinancialPostingStandard.txt>
  153.  
  154. My Stuff
  155.  
  156. The registration sample code should be at <URL:ftp://ftp.rahul.net/pub/
  157. flasheridn/developers/
  158. RegisterSampleCode.sit.hqx>
  159.  
  160. The latest version of Register should be at <URL:ftp://ftp.rahul.net/pub/
  161. flasheridn/Register.sit.hqx>
  162.  
  163. Kagi Shareware
  164. 1442-A Walnut Street #392
  165. Berkeley, California, 94709-1405 USA
  166. Email: shareware@kagi.com 
  167. FAX: +1 510 652 6589
  168.  
  169. Don't send checks or money to this address until you have received
  170. confirmation that Kagi can accept payment for the program you are trying to
  171. register, and a registration number, which must accompany your payment. 
  172. Cash received without a confirmation number may be donated to charity, and
  173. checks may be shredded.
  174.  
  175. The Author
  176.  
  177. Please send any comments about this program to FlaSheridn@kagi.com.  
  178.  
  179. Flash Sheridan
  180. 180A Hamilton Avenue #601
  181. Palo Alto, California 94301-1682
  182. <URL:ftp://ftp.rahul.net/pub/flasheridn/>
  183. <URL:http://www.rahul.net/flasheridn/>
  184.  
  185. Copyright and Acknowledgment
  186.  
  187. This program may be freely distributed, and is free to end users; ⌐1994
  188. Flash (K.J.) Sheridan.  Programmers and shareware clearing houses should see
  189. above for licensing details.
  190.  
  191. It was inspired by Peter N Lewis's Register for the Macintosh, but problems
  192. with the Newton version are not his fault.  Thanks to Chris Owen for the
  193. credit card checking code, and to Hardy Macia and Rob Bruce for the buttons.
  194.  
  195. Version 1.0.2
  196.